--- title: 参数说明/常用命令 description: "软件包支持根据命令行完成一键式安装，各个命令之间可以配合使用，用户根据安装需要选择对应参数完成安装，所有参数都是可选参数。" url: https://www.hiascend.com/document/detail/zh/Atlas%20200I%20A2/latest/ep/installationguide/Install_91.html sourcePath: /source/zh/Atlas 200I A2/260RC1/ep/installationguide/Install_91.html indexId: 782d9d4edd33f8c7dca5dcb8cfc8c0c873633748cf6a2e21b7668315b3a8672868 --- # 参数说明/常用命令 #### 参数说明 软件包支持根据命令行完成一键式安装，各个命令之间可以配合使用，用户根据安装需要选择对应参数完成安装，所有参数都是可选参数。 安装命令格式： ./xx.run [options] 详细参数请参见表1。 - 软件包中的xx请根据实际情况进行替换。 - 如果通过./xx.run--help命令查询出的参数未解释在如下表格，则说明该参数预留或适用于其他芯片版本，用户无需关注。 **表1 安装包支持的参数说明** | 参数 | 说明 | | --- | --- | | \-\-help或者\-h | 查看帮助信息。 | | \-\-info | 显示数据包详细信息。 | | \-\-list | 导出安装包文件列表。 | | \-\-check | 校验软件包的完整性。 | | \-\-quiet | 静默安装，跳过交互式信息。 使用该参数进行安装时，若安装目录权限大于755，则会提示安全风险，用户自行选择终止安装或选择其他权限为755的安装目录重新安装。 使用示例：./xx.run \-\-full \-\-quiet 说明： Driver和Firmware软件包在使用该参数时，不能与\-\-uninstall配合使用。 | | \-\-nox11 | 安装过程中不弹出图形终端窗口。 使用示例：./xx.run \-\-full \-\-nox11 说明： 该参数预留，暂不使用。 | | \-\-noexec | 不执行安装脚本。配套\-\-extract=path使用。格式为：\-\-noexec \-\-extract=path | | \-\-extract= | 解压缩安装包中文件到指定目录。使用该参数时，用户无需手动建立指定的目录，解压过程中会自动创建，例如： \-\-noexec \-\-extract=./package，则命令执行后会自动将解压后的内容放在package目录。 | | \-\-tar arg1 [arg2 …] | 对安装包执行tar命令，使用tar后面的参数作为命令的参数。例如执行\-\-tar xvf命令，解压软件包的内容到当前目录。 | | \-\-full | 完整安装类型：安装所有文件。 | | \-\-run | 运行态类型：只安装运行场景需安装的文件。 | | \-\-devel | 开发态类型：包含用户开发时需要用到的头文件。 Firmware包不支持该参数。 | | \-\-docker | 容器场景下安装，仅用于Driver包，其他软件包默认按full模式。 | | \-\-upgrade | 升级。 首次安装场景，系统默认安装到“/usr/local/Ascend”目录。 非首次安装场景，仅支持从软件包所在路径升级。 说明： 该参数不能与\-\-install\-username、\-\-install\-usergroup、\-\-install\-for\-all其中任意一个参数配合使用。 | | \-\-install\-username= | 首次安装：可以指定运行用户名，若不指定，则默认是HwHiAiUser。 覆盖安装：沿用上次运行用户名。 说明： 该参数需要配合“\-\-install\-usergroup=”一起使用，并且username需要与创建的用户（创建运行用户）保持一致。 如果使用参数\-\-install\-username=root \-\-install\-usergroup=root，则需要与\-\-install\-for\-all参数配合使用，该场景下权限控制可能存在安全风险 Firmware安装不支持指定运行用户名和用户组，共用Driver的运行用户名和用户组。 | | \-\-install\-usergroup= | 首次安装：可以指定运行用户组，若不指定，则默认是HwHiAiUser。 覆盖安装：沿用上次运行用户组。 说明： 该参数需要配合“\-\-install\-username=”一起使用，并且usergroup需要与创建的用户组（创建运行用户）保持一致。 | | \-\-install\-path= | 指定安装目录，如不指定，默认安装路径为：/usr/local/Ascend。 若通过该参数指定了安装路径，运行用户需要对指定的安装路径有可读写权限。安装路径支持大小写字母（a\-z，A\-Z）、数字（0\-9）、下划线（\_）、中划线（\-）、句点（.（非相对路径））、单个/（文件名或目录不支持/）。 说明： Firmware安装不支持指定路径，共用Driver的安装路径。 指定路径安装过程中，系统会对“自定义安装路径/driver/device/\*”字符串的长度进行逐一校验（\*代表该路径下的全部文件），若等于或大于128个字符则会安装失败。 | | \-\-install\-for\-all | 安装时，允许其他用户具有安装群组的权限。 当安装携带该参数时，软件包中创建的目录及文件，其他用户权限=安装群组权限。 首次安装过程中如果使用了\-\-install\-for\-all参数，建议覆盖安装中也保留\-\-install\-for\-all参数，否则会导致NPU设备权限变更。 使用示例：./xx.run \-\-full \-\-install\-for\-all 说明： 使用该参数将会存在安全风险：其他所有用户都有权限访问安装目录，请谨慎使用。 Firmware不支持该参数。 安装时如果使用该参数： 如果安装路径不存在，则安装过程中会自动创建默认路径，例如：$HOME/Ascend，该路径权限为755，其他用户可以正常使用。 如果安装路径已存在，则请确保该目录权限至少为755，否则将会终止安装。 | | \-\-reset | 恢复初始化配置（该参数只适用于Firmware包）： \-\-full \-\-reset参数通过安装方式恢复初始化配置，需立即重启生效；若安装失败，则恢复初始化配置失败。 \-\-upgrade \-\-reset参数通过升级方式恢复初始化配置，需立即重启生效；若升级失败，则恢复初始化配置失败。 说明： 该参数预留，暂不支持使用。 \-\-reset参数只支持\-\-full \-\-reset与\-\-upgrade \-\-reset两种模式的使用方法，不支持与其它参数配合使用，也不支持单独使用。 | | \-\-uninstall | 卸载当前已安装软件包。 | | \-\-version | 查询当前安装包版本信息详情。 | 举例说明： - full模式下安装 - 不指定安装目录：./xx.run--full - 指定安装目录：./xx.run--full --install-path=安装路径 - docker模式下安装（仅支持Driver包） - 不指定安装目录：./xx.run--docker - 指定安装目录：./xx.run--docker --install-path=安装路径 - run模式下安装 - 不指定安装目录：./xx.run--run - 指定安装目录：./xx.run--run --install-path=安装路径 - 开发态模式下安装 - 不指定安装目录：./xx.run--devel - 指定安装目录：./xx.run--devel --install-path=安装路径